home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / c / qnxker.man < prev    next >
Encoding:
Text File  |  1988-08-16  |  15.3 KB  |  421 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.      KERMIT(1)                QNX Software Manual                 KERMIT(1)
  68.  
  69.  
  70.      NAME        NAME 
  71.           kermit - file transfer, virt.  terminal over tty link 
  72.  
  73.      SYNOPSIS        SYNOPSIS 
  74.  
  75.                kermit c [ lbe ] [ line ] [ baud ] [ esc ] 
  76.  
  77.                kermit r [ ddilb ] [ line ] [ baud ] 
  78.  
  79.                kermit s [ ddilb ] [ l
  80. ine ] [ baud ] file ...  
  81.  
  82.      DESCRIPTION        DESCRIPTION 
  83.           Kermit                                                                   Kermit provides reliable file transfer and primitive virtual 
  84.           terminal communication   between  machines.    It  has  been
  85.           implemented   on   many   different   computers,   including
  86.           microprocessors (see  below).   The files transferred may be
  87.           arbitrary ASCII  data  (7-bit  characteand  may  be  of  any
  88.          length.    The   file   transfer  protocol  uses  small  (94
  89.           character) checksummed packets, with ACK/NACK responses  and
  90.                        Kermit                                                     timeouts.    Kermit currently uses a five second timeout and
  91.           ten retries.  
  92.  
  93.                                  kermit                                                The arguments to  kermit are a set of flags (no  spaces
  94.           between the flags), three optional
  95. args (which, if included, 
  96.           must  be in the same order as the flags which indicate their
  97.           presence), and, if this is a Send operation a list of one or 
  98.                                                                    tar            more files.  (It is similar in some way to  the  Unix    tar
  99.           command structure).  
  100.  
  101.                Kermit                                                                   Kermit has three modes, Connect, Send, and Receive. The
  102.      first  is  for  a virtual terminal connection, the other two
  103.           for file transfer.  These modes are specified by  the  first
  104.                                 c  s  or r                                         flag, which should be c, s, or r, respectively.  Exactly one 
  105.           mode must be specified.  
  106.  
  107.                       d                     kermit                                     The    d flag (debug) makes  kermit a bit more verbose.
  108.                      kermit
  109.                                               The states kermit goes through are printed along with  other
  110.                                                      d                            traces  of  it's  operation.    A  second  d flag will cause
  111.           kermit                                                   kermit to give an even more detailed trace.  
  112.  
  113.                     i                                                                   The  i flag (image) allows slightly more efficie
  114. nt file 
  115.           transfer between  Unix  machines.    Normally  (on   Kermits
  116.           defined to run on Unix systems) newline is mapped to CRLF on 
  117.           output, CR's are discarded on input, and bytes are masked to 
  118.           7 bits.  If this is set, no mapping is done on newlines, and 
  119.           all eight  bits  of each byte are sent or received.  This is
  120.           the default for non-Unix kermits.  
  121.  
  122.                     l                                           kermit
  123.       The  l flag (line) specifies the tty line that   kermit
  124.           should use  to  communicate with the other machine.  This is
  125.                                                                      l            specified as a regular device name, like "$mdm". If  no    l
  126.                                                                 kermit            option  is  specified,  standard  input  is used and  kermit
  127.           assumes it is running  on  the  remote  host  (ie.  NOT  the
  128. machine to which your terminal is attached).  
  129.  
  130.                       b                                                                The    b  flag  (baud)  sets  the baud rate on the line
  131.                            l                                    b                  specified by the l flag.  No changes are made if the  b flag 
  132.           is not used.  Legal speeds are: 110, 150, 300,  1200,  2400,
  133.  
  134.  
  135.                                       -1-
  136.  
  137.  
  138.      KERMIT(1)                QNX Soft
  139. ware Manual                 KERMIT(1)
  140.  
  141.  
  142.           4800, 9600.  
  143.  
  144.                       e                                                                The    e flag (escape) allows the user to set the first
  145.           character of the two character escape sequence  for  Connect
  146.                                                       kermit                       mode.  When the escape character is typed,  kermit will hold 
  147.           it and  wait  for the next character.  If the next character
  148.  
  149.               c     C  kermit                                                     is  c or  C, kermit  will  close  the  connection  with  the
  150.                                                               b     B             remote host.    Similarly, if the next character is b or  B,
  151.           kermit                                                                  kermit will send a BREAK signal to the remote host.  If  the
  152.                                      ____
  153.           second  character  is  the same as the escape character, the
  154.           escape character itself is passed.  Any character other than 
  155.           these three results in a  bell  being  sent  to  the  user's
  156.           terminal and  no  characters passed to the remote host.  All
  157.           other typed characters are passed through  unchanged.    The
  158.           default escape character is '^'.  
  159.  
  160.                       p                                                                The
  161. p  flag  (parity)  allows  parity  to  be set on
  162.           outgoing packets and stripped on incoming  ones.    This  is
  163.           useful  for  communicating  with IBM hosts or over networks,
  164.           such as TELENET, that usurp the parity bit.    The  possible
  165.           values  for  parity  are mark, space, even, odd or none (the
  166.           default).  
  167.  
  168.                     t                         kermit                                    The  t flag (turnaround) tells kermit while in protoc
  169. ol 
  170.           mode  (sending  or  receiving)  to  wait  for  a  turnaround
  171.           character  (XON)  from  the other host after receiving every
  172.                                              kermit                                packet.  This is necessary to run  kermit with a half duplex 
  173.           host such as an IBM mainframe.  
  174.  
  175.                     h                            kermit                                The  h flag (half duplex) makes   kermit  echo  locally
  176.           any char
  177. acters   typed  in  connect  mode.    This  is  also
  178.           necessary to communicate with a half duplex system  like  an
  179.           IBM  370.   The file arguments are only meaningful to a Send
  180.           kermit                  kermit                                          kermit.  The Receiving  kermit will  attempt  to  store  the
  181.           file  with  the  same  name  that  was used to send it.  QNX
  182.           kermits                                                                 kermits n
  183. ormally convert outgoing file  names  to  uppercase
  184.                                                         f                         and incoming  ones  to  lower  case (see the  f flag).  If a
  185.           filename contains a slash  (/)  all  outgoing  kermits  will
  186.           strip  off  the  leading  part  of the name through the last
  187.           slash.  
  188.  
  189.      EXAMPLE        EXAMPLE 
  190.           For this example we will assume two QNX machines.    We  are
  191.           logged   onto  "qnxa"  (the
  192.   local  machine),  and  want  to
  193.           communicate with "qnxb" (the remote machine).   There  is  a
  194.           modem on "$mdm".  
  195.  
  196.                We  want to connect to "qnxb", then transfer "file1" to
  197.           that machine.  
  198.  
  199.           We type: kermit clb $mdm 1200 
  200.  
  201.           Kermit answers: Kermit: connected...  
  202.  
  203.           Now we dial  the  remote  machine  and  connect  the  modem.
  204.           Anything  typed  on  the terminal will be sent to the remote
  205.           machine a
  206. nd any output from that machine will  be  displayed
  207.           on our  terminal.   We hit Control-Z, get a login herald and
  208.  
  209.  
  210.                                       -2-
  211.  
  212.  
  213.      KERMIT(1)                QNX Software Manual                 KERMIT(1)
  214.  
  215.  
  216.           log in.  
  217.  
  218.                                        kermit                                           Now we need to start a  kermit on the remote machine so 
  219.           that we can send the file over.    First  we  start  up  the
  220.                                               kermit                             remote,  (in  this  case receiving)  kermit, then the local,
  221.           (sending) one.  Remember that we are talking to  qnxb  right
  222.           now.  
  223.  
  224.                We type: kermit r 
  225.                                    kermit                      (there is now a Receive  kermit on qnxb) 
  226.  
  227.                                                              c                         We  type  ^  (the escape character) a
  228. nd then  c to kill
  229.                                   kermit               the local (Connecting)  kermit.  
  230.  
  231.                Kermit disconnected.  
  232.  
  233.                We type: kermit slb $mdm 1200 file1 
  234.  
  235.                Kermit answers: Sending file1 as FILE1 
  236.  
  237.                                                     kermit                             When the transmission is finished,   kermit  will  type
  238.           either  "Send complete", or "Send failed.", depending on the
  239.           success
  240.  of the transfer.  If we now  wanted  to  transfer  a
  241.           file  from qnxb (remote) to qnxa (local), we would use these
  242.           commands: 
  243.  
  244.  
  245.                     kermit clb $mdm 1200
  246.                     (connected to qnxb)
  247.                     kermit s file9
  248.                     ^c (up-arrow c not control-c)
  249.                     (talking to qnxa again)
  250.                     kermit rl $mdm 1200
  251.  
  252.  
  253.  
  254.                After all the transfers were done,  we  should  connect
  255.                                   kermit                         again, log off of qnxb, kill the Connect  kermit and hang up 
  256.           the phone.  
  257.  
  258.                Detail  on other implementations and on the protocol is
  259.                         ______ _____ _____            ______  ________            given in the  Kermit Users Guide , and the  Kermit  Protocol
  260.           ________             Handbook 
  261.  
  262.      FEATURES        FEATURES 
  263.  
  264.                The   KERMIT   Protocol   uses   onl
  265. y   printing  ASCII
  266.           characters, Ctrl-A, and CRLF. Ctrl-S/Ctrl-Q flow control can 
  267.           be  used  "underneath"  the  Kermit  protocol  (TANDEM  line
  268.           discipline on Berkeley Unix).  
  269.  
  270.                       kermit                                                           This   kermit does have timeouts when run under QNX, so
  271.           the  protocol  is  stable  when  communicating  with  "dumb"
  272.           kermits (that don't have timeouts).  
  273.  
  274.      OTHER IMPLEMENTATIO
  275. NS        OTHER IMPLEMENTATIONS 
  276.           Kermits  have been written for TOPS-20, TOPS-10, IBM VM/CMS,
  277.           Unix, VAX/VMS, RT-11, MS-DOS, CP/M, and Apple DOS.  
  278.  
  279.  
  280.                                       -3-
  281.  
  282.  
  283.      KERMIT(1)                QNX Software Manual                 KERMIT(1)
  284.  
  285.  
  286.                         kermit                                                         The QNX  kermit in use at Merrell Dow has  been  tested
  287.           with  MS-Kermit (PC-DOS), Ckermit (Xenix), U
  288. nix Kermit (Unix
  289.           System V) Kermit-11 (RSX-11M) ,  Kermit-32  under  VMS,  and
  290.           Kermit-20  under  TOPS-20.  More information is given in the
  291.           ______ _____ _____               Kermit Users Guide.  
  292.  
  293.      SEE ALSO        SEE ALSO 
  294.           stty(1) 
  295.  
  296.                ______ _____ _____  ______ _______  _ ___ __                             Kermit Users Guide, Fourth Edition (4 May 83), Frank da 
  297.           Cruz, Daphne Tzoar, Bill Catchings 
  298.  
  299.                ____
  300. __ ________ ______  ________ _______  _   __  _____                 Kermit Protocol Manual, Protocol Version  3  (29  April
  301.           __                                             83), Frank da Cruz, Bill Catchings 
  302.  
  303.                Both  of  the  above  documents  are  from the Columbia
  304.           University Center for Computing Activities,  New  York,  New
  305.           York, 10027.  
  306.  
  307.      AUTHORS        AUTHORS 
  308.           KERMIT  kernel by Bill Catchings, Columbia University Center
  309.      for Computing Activities 
  310.  
  311.                KERMIT-Unix adaptation by Chris Maio and  Bob  Cattani,
  312.           Columbia University Computer Science Dept.  
  313.  
  314.                Local  mods  for v6, System III, and System V by Walter
  315.           Underwood. Includes bug fixes from Jim Guyton at RAND-Unix.  
  316.  
  317.                KERMIT-QNX adaption by Anthony J. Starks at Merrell Dow 
  318.           Research Institute.  
  319.  
  320.      DIAGNOSTICS        DIAGNOSTICS 
  321.            cannot open device
  322.   "cannot open device" 
  323.  
  324.                                  line                                             The file named in the  line argument did not  exist  or  had
  325.           the wrong permissions.  
  326.  
  327.            bad line speed              "bad line speed" 
  328.  
  329.                baud                                              The  baud argument was not a legal speed.  
  330.  
  331.            Could not create file              "Could not create file" 
  332.  
  333.                         kermit
  334.                                         A  Receive    kermit could not create the file being sent to
  335.           it.  
  336.  
  337.            nothing to connect to              "nothing to connect to" 
  338.  
  339.                      kermit                        line                        A Connect  kermit was started without a  line argument.  
  340.  
  341.      BUGS AND CAVEATS        BUGS AND CAVEATS 
  342.           There is no  locking  on  the  use  of  the  outgoing  line.
  343.                                      kermit
  344.                                       Several  users  could run  kermit  (or anything else) on the
  345.           line simultaneously.  
  346.  
  347.                The name "kermit" is not an acronym,  but  named  after
  348.           the frog  of  Seasame Street fame.  ("Kermit" is also Celtic
  349.  
  350.  
  351.                                       -4-
  352.  
  353.  
  354.      KERMIT(1)                QNX Software Manual                 KERMIT(1)
  355.  
  356.  
  357.           for "free") 
  358.  
  359.                This  implementation   does   not   send   or
  360.    process
  361.           error-message packets.  
  362.  
  363.                Eight-bit quoting is not implemented.  
  364.  
  365.                Terminal  emulation mode drops characters after 1200(?)
  366.           baud.  
  367.  
  368.                The message "GETC: file not open for read" or some such 
  369.           may occur during transfers.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.                                       -5-
  419.  
  420.  
  421.